home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmRenderTable.z / XmRenderTable
Encoding:
Text File  |  2002-10-03  |  11.7 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee - Data type for a render table
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           #include <Xm/Xm.h>
  13.           XmRenderTable
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents Motif 2.1.
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee is the data type for a render table, which
  20.           contains a table of renditions (XXXXmmmmRRRReeeennnnddddiiiittttiiiioooonnnns). Each
  21.           rendition consists of a set of attributes for rendering
  22.           text, including a font or fontset, colors, tabs, and lines.
  23.           Each rendition is identified with a tag.
  24.  
  25.           When a compound string is displayed, for each segment in the
  26.           string, the rendition used to render that string is formed
  27.           as follows. If the segment has at least one rendition begin
  28.           tag or if the list of tags formed by accumulating from
  29.           previous segments the rendition begin tags and removing the
  30.           rendition end tags is not empty, these tags are matched with
  31.           renditions in the render table. The effective rendition used
  32.           to render the segment is formed by successively merging each
  33.           rendition found into the current rendition with non-
  34.           XXXXmmmmAAAASSSS____IIIISSSS(XXXXmmmmUUUUNNNNSSSSPPPPEEEECCCCIIIIFFFFIIIIEEEEDDDD____PPPPIIIIXXXXEEEELLLL for color resources) values for
  35.           resources in the rendition to be merged, thus replacing the
  36.           corresponding values of the resources in the current
  37.           rendition. Finally, if the resulting rendition still has
  38.           resources with unspecified values and the segment has a
  39.           locale or charset tag (these are optional and mutually
  40.           exclusive) this tag is matched with a rendition in the
  41.           render table, and the missing rendition values are filled in
  42.           from that entry.
  43.  
  44.           If no matching rendition is found for a particular tag, then
  45.           the XXXXmmmmNNNNnnnnooooRRRReeeennnnddddiiiittttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk of the XXXXmmmmDDDDiiiissssppppllllaaaayyyy object is called
  46.           and the render table is searched again for that tag.
  47.  
  48.           If the resulting rendition does not specify a font or
  49.           fontset, then for segments whose text type is
  50.           XXXXmmmmCCCCHHHHAAAARRRRSSSSEEEETTTT____TTTTEEEEXXXXTTTT, the render table will be searched for a
  51.           rendition tagged with XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG, and if a
  52.           matching rendition is found, it will be merged into the
  53.           current rendition. If the resulting rendition contains no
  54.           font or fontset, the XXXXmmmmNNNNnnnnooooFFFFoooonnnnttttCCCCaaaallllllllbbbbaaaacccckkkk will be called with
  55.           the default rendition and "" as the font name. If no
  56.           rendition matches or no font was found after the callback,
  57.           then the first rendition in the render table will be merged
  58.           into the current rendition. If this rendition still has no
  59.           font, then the segment will not be rendered and a warning
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           will be emitted.
  75.  
  76.           For segments whose text type is XXXXmmmmMMMMUUUULLLLTTTTIIIIBBBBYYYYTTTTEEEE____TTTTEEEEXXXXTTTT or
  77.           XXXXmmmmWWWWIIIIDDDDEEEECCCCHHHHAAAARRRR____TTTTEEEEXXXXTTTT, the render table will be searched for a
  78.           rendition tagged with ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____LLLLOOOOCCCCAAAALLLLEEEE, and, if a
  79.           matching rendition is found, it will be merged into the
  80.           current rendition. If the resulting rendition contains no
  81.           font, the XXXXmmmmNNNNnnnnooooFFFFoooonnnnttttCCCCaaaallllllllbbbbaaaacccckkkk will be called with the default
  82.           rendition and "" as the font name.  An application can have
  83.           this callback attempt to remedy this problem by calling
  84.           XXXXmmmmRRRReeeennnnddddiiiittttiiiioooonnnnUUUUppppddddaaaatttteeee on the input rendition to provide a font
  85.           for the widget to use. This may be done by either providing
  86.           an alternative font name to be loaded using the XXXXmmmmNNNNffffoooonnnnttttNNNNaaaammmmeeee
  87.           and XXXXmmmmNNNNffffoooonnnnttttTTTTyyyyppppeeee resources or with an already loaded font
  88.           using the XXXXmmmmNNNNffffoooonnnntttt resource.  If no rendition matches or no
  89.           font was found after the callback, then the segment will not
  90.           be rendered and a warning will be issued.
  91.  
  92.           Render tables are specified in resource files with the
  93.           following syntax:
  94.  
  95.           _r_e_s_o_u_r_c_e__s_p_e_c: [ _t_a_g [, _t_a_g ]* ]
  96.  
  97.           where _t_a_g is some string suitable for the XXXXmmmmNNNNttttaaaagggg resource of
  98.           a rendition.
  99.  
  100.           If no tags are specified, then a render table will be
  101.           created that is either empty or contains only a rendition
  102.           with a tag of ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____LLLLOOOOCCCCAAAALLLLEEEE.
  103.  
  104.           Specific values for specific rendition resources are
  105.           specified using the following syntax:
  106.  
  107.           _r_e_s_o_u_r_c_e__s_p_e_c [*|.] _r_e_n_d_i_t_i_o_n[*|.] _r_e_s_o_u_r_c_e__n_a_m_e: _v_a_l_u_e
  108.  
  109.           where:
  110.  
  111.           _r_e_s_o_u_r_c_e__s_p_e_c
  112.                     Specifies the render table.
  113.  
  114.           _r_e_n_d_i_t_i_o_n Is either the class Rendition or a tag.
  115.  
  116.           _r_e_s_o_u_r_c_e__n_a_m_e
  117.                     Is either the class or name of a particular
  118.                     resource.
  119.  
  120.           _v_a_l_u_e     Is the specification of the value to be set.
  121.  
  122.           Any resource line that consists of just a resource name or
  123.           class component with no rendition component or loose binding
  124.           will be assumed to specify resource values for a rendition
  125.           with a tag of ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____LLLLOOOOCCCCAAAALLLLEEEE. In effect, this creates
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee((((3333XXXX))))
  137.  
  138.  
  139.  
  140.           a default rendition in much the same way that specifying no
  141.           fontlist tag for a fontlist resource causes the fontlist
  142.           created to contain an entry tagged with
  143.           XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG:
  144.  
  145.           _r_e_s_o_u_r_c_e__s_p_e_c._r_e_s_o_u_r_c_e__n_a_m_e: _v_a_l_u_e
  146.  
  147.           For example, the following would set the XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee
  148.           resource of llllaaaabbbbeeeellll1111 to a render table consisting of three
  149.           renditions tagged with ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____LLLLOOOOCCCCAAAALLLLEEEE, _b_o_l_d, and
  150.           _o_b_l_i_q_u_e, with values for resources set as described in the
  151.           resource specifications.
  152.  
  153.           *label1.renderTable: bold, oblique
  154.           *label1.renderTable.bold.renditionForeground: Green
  155.           *label1.renderTable.bold.fontName: *-*-*-bold-*-iso8859-1
  156.           *label1.renderTable.bold.fontType: FONT_IS_FONT
  157.           *label1.renderTable.oblique.renditionBackground: Red
  158.           *label1.renderTable.oblique.fontName: *-*-*-italic-*-iso8859-1
  159.           *label1.renderTable.oblique.fontType: FONT_IS_FONT
  160.           *label1.renderTable.oblique.underlineType: AS_IS
  161.           *label1.renderTable.fontName: fixed
  162.           *label1.renderTable.fontType: FONT_IS_FONT
  163.           *label1.renderTable.renditionForegound: black
  164.           *label1.renderTable*tabList: 1in, +1.5in, +3in
  165.  
  166.      RRRREEEELLLLAAAATTTTEEEEDDDD
  167.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss(3), XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeCCCCooooppppyyyy(3),
  168.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeCCCCvvvvttttFFFFrrrroooommmmPPPPrrrroooopppp(3), XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeCCCCvvvvttttTTTTooooPPPPrrrroooopppp(3),
  169.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeFFFFrrrreeeeeeee(3), XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeGGGGeeeettttRRRReeeennnnddddiiiittttiiiioooonnnn(3),
  170.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeGGGGeeeettttRRRReeeennnnddddiiiittttiiiioooonnnnssss(3), XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeGGGGeeeettttTTTTaaaaggggssss(3),
  171.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeRRRReeeemmmmoooovvvveeeeRRRReeeennnnddddiiiittttiiiioooonnnnssss(3), XXXXmmmmRRRReeeennnnddddiiiittttiiiioooonnnn(3), and
  172.           XXXXmmmmSSSSttttrrrriiiinnnngggg(3).
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.